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1 What is iBus? 

iBus is a pure Jav£lT^^|!^^^|^^^^ ^^.^ allowing disiiibuted components to exchange 

information via a variety of communication protocols and qualities of service! As a result, only a 
loose coupling of components is maintained, rendering components easier to reuse and applications 
easier to extend. In order to exchange information, components join one (or multiple) iBus commu- 
nication cJwnnels. Components produce information and feed it into channels or receive informa- 
tion by subscribing to channels. Any kind of serializable Java object can be transmitted v^ixh iBus. 
iBus supports reliable asynchronous push communication as well as synchronous ^efjuestArepl^ 
style communication. The latter is analogous to CORE A and RMI and allows a component t^^ 
plicitly request a piece of information via an iBus channel Unlike CORBA and RMI, iBus re- 
quest/reply style communication relies on muhicast and is thus fauU-tolerant. iBus employs TCT/IP 
and IP multicast to deliver information. 

I^^ISfflJf^ig^ protoco[,gmilY;,^ !?H*^^liii^ 

ling, and satelli^^^ Thus iBus becomes interesting for ap^^^^^^ 

ent/server systems as well as for embedded systems. iBus supports tying a QoS to each iBus 

communication channel, i.e. reliable point-to-point communication, reliable multicast, best-effort 

communication, enciyption, failure detection etc. 

Below we provide an application example to demonstrate how a rather sophisticated financial data 
delivei7 application can effortlessly be implemented, using iBus. Ftmally, the iBus programming 
model and QoS fj amework is explained in moi:e detail. 



2 Example 1: StockQuote Producer and Consumer 

The first example deals with receiving financial infonnation from a source such as Reuters and its 
distribution via iBus to data visualization tools running on trader workstations. The data collector 
and the ti ader workstations are interconnected by a local area network allowing iBus to deliver in- 
formation by its nsliable IP multicast protocol. 
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Figure 1 : Stock quotes are encapsulated in Java objects and sent to a dynatnic set of 
visualization tools. 



In a typical trading floor environment many trader workstations plug into the network to receive fi- 
nancial information almost in real-time. Therefore, the distribution of information can not be ac- 
complished by a point-to-point protocol such as TCP/IP without overloading the network. A 
multicast protocol avoids redundant network load and provides better scalability. 

2.1 The StockQuoteProducer Application 

The necessary code to implement a fully functional producer of financial stock quote events can be 
found below: 

1 import ch.softwired.ibus. *; 

2 

3 public class StockQuoteProducer { 

4 public static void nvain (String [] arga) throws Exception { 

5 int pu3bCounter ^ 0; 
6 

7 Publisher p = new Publisher (); 

8 Channel blueChipsZRH = new Channel ( ) ; 

9 ChanaelURL url ^ new ChannelURL { "ibus : ///quotes/ 2:rh/bluechips" ) ; 
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10 blueChipaZRM.setChannelURL(url) ; 

11 p.setChannel (blueChipsZRH) ; 
12 

13 while (true) { 

14 p. publish ("Quotet " + +-tpushCounter + " IBM 118"); 

15 System, out .printlnC "Published guote# " pushCounter) ; 

16 try f 

17 Thread. currentThreadO .sleep (1000) ; 

18 } catch (InterruptedException e) {} 

19 } 

20 } 

21 } 

In order to push Java objects into an iBus channel an instance of die class ch. soft- 
wired, ibus . Piiblisher is created on line 7. Next, an instanceof the Channel class is ere- 
ated (line 8) and an iBus ChannelURL is assigned to the channel (lines 9 and 10). Finally, on line 
1 1 the Piiblisher object is tied to the channel. Now the P\iblisher is ready to transmit event 
objects on the channel. 

As we will see in Section 4. 1, a CharmelURL fully denotes an iBus channel by providing a hier- 
archical topic name for the transmitted information and an (optional) quality of service specification 
for the channel In our case, the channel is used to transmit blue chips stock quotes from Itie Zurich 
stock exchange, hence the topic name " /quotes/zrh/bluechips " . 

The infinite loop from line 13 to 19 is used to transmit fictitious IBM stock quotes via the channel. 
The quotes are encapsulated in java . lang . String objects, although any other serializable 
Java object can be transmitted as well. After publishing a quote a status message is written to the 
console and the publisher is suspended for one second. 

2o2 nine StockQuot^onsumer ApplicatioB 

An appIication|aj[Djr>m^^ written to receive stock cjuotes. The consumer 

^ain difference ji^iste' m 

cording to the JavaBeans model, iBus invokes the PubllshListene^^ 
ent method when a quote is received on the blue chips channel. 

1 import ch.sof twired.ibus. *; 

2 import ch. softwired. ibus .u til . ThreadHelper; 
3 

4 public class StockQuoteConsumer implements PublishListener { 

5 public static void main (String f ] args) throws Exception { 

6 StockQuoteConsumer consumer = new StockQuoteConsumer () ; 

7 Subscriber s = nevj Stibscriber ( ) ; 

8 Channel blueChips2RH = new Channel ( ) ; 

9 ChannelURIi url = new ChannelURL ( "ibus : ///quotes/zrh/bluechips" ) ; 

10 blueChipsZRH. 3etChannelURL(url) ; 

11 s . setChannel (blueChipsZRH) ; 
12 

13 9 .addPublishListener {consumer) ; 
14 

15 ThreadHelper .WAIT„UWTIL_EXIT. suspend ( ) ; 

16 } 

17 
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18 public void handlePublishEvent (PublishBvent event) { 

19 String quote = (String) event . getObject () ; 

20 System. out. println( "Got a stock quote: + emote 1 • 

21 } ^ / * 

22 J 

First, we need an instance of interface PublishListener. For simplicity we let class Stock- 
QuoteProducer implement the interface and we then create an instance on line 6. To comply 
with the JavaBeans model our PublishListener object needs to be connected to a local source 
of PublishEvent objects. To achieve this we create a Subscriber object on line 7 and tie it 
to the blue chips channel (line 8 to 11). 

On line 13 we connect the listener with the subscriber. The peculiar line 15 is needed to suspend the 
main tliread in such a jnanner that the consumer application will keep printing incoming stock 
quotes until interrupted by the user. 

Lines 18 to 21 provide the implementation of the aforementioned PublishListener .han- 
dlePxiblishEvent method, called by iBus, to deliver a Publ ishEvent to the stock quote con- 
sumer application. 

The following happens when the StoclcQuoteProducer enters the Producer .publish 
method: 

1. The string object is serialized by iBus and is reliably transmitted on the blue chips channel by IP 
multicast 

2. The TP multicast datagram is received by the consumer's iBu5 middleware layei-s, deserialized, 
put in a PublishEvent object and passed oa to the Subscriber object 

a.The Subscriber now passes the PublishEvent along to StockQuoteConsum- 
er .handlePubl ishEvent. 

2.3 Consideratioims 

° .^J?..??^®,^^^^ gracefully: ^pu can stoit a^ many quQ^ 

;anotberat_m^ 

Light-weight channeOs: for the sake of simplicity our application uses only one iBus channel 
Applications can use many channels at the same time, and channels can be allocated 
temporarily or for the whole lifetime of the application. 

Filtering: a consumer recei ves only the events sent to the channels it is subscribed to. Hence 
producers and consumers need to agree on a ChannelURL in oider to communicate. 

n^m^ protoc^ of iBus. ^s deifaSt (il^ 

for example to TCP/IP, wihen tW^tiaSriefTO . - - . 

- Scalability: IP multicast impUes that the same datagram is received by multiple destinations on 
the intranet thus eliminating the need to replicate the datagi-am once for every destination. The 
network load thus remains constant and better efTiciency is achieved than with TCP/IP. 
" IFuIIy distributed: iBus requires neither naming services nor background daemons to administer 

its IP multicast channels. Tlie iBus middleware is fully distributed and fault-tolerant 
*• Spontaneous networking of components and devices is enabled in a fully fault-tolemnt and 
scalable manner 

^^^^ ^ © SoftWired AG 1999 
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3 Example 2: SmartStockQuote Producer and Consumer 

A disadvantage of the previous StockQuoteProducer application is that events are published 
even if no consumers are subscribed to the blue chips channel. Thus network bandwidth is wasted 
if no consumer appUcations are available. Fortunately, iBus offers a convenient tracking mechanisjn 
of channel subscriptions and unsubscriptions as well as application failui-es. 
In the following example we illustrate a modified quote producer only publishing quotes if at least 
one consumer is subscribed to the bhie chips channel and stopping publishing as soon as the^re are 
no more consumers. To achieve this we need to implement the iBus interface Channel- 
ViewChangeListener and to register an instance of it with our blue chips channel. Now iBus 
^^^^ ?J?.^.?^^AYif . handleChiannelViGwCh 

ISMH?.^iiisconn Tlie changes made to StockQuoteProducer in boldface: 

I import ch- sof twired. xbus. *; 
2 

3 public class Smart StockQuoteProducer 
implements Channel Viev/ChangeListener { 

4 

5 private static Object guard « new Object {); 

6 private static boolean listenerHore « false; 

7 

8 public static void main(String [] args) throws Exception { 

9 int pushCounter = 0; 
10 

II Publisher p = new Publisher (); 

12 Channel blueChipsZRH ~ new Channel ( ) ; 

13 ChannelURL url = new ChanneltTRL (" ibus :// /quotes/ zrh/bluechips" ) ; 

14 blueChipsZRH. setChannelURL( url) ; 

15 p. setChannel (blueChipsZRH) ; 
16 

17 ChannelViewChangeListener 1 = new SmartStockQuoteProducer { } ; 

18 blueChipsZRH. addChannelViewChangeListener (1 ) 9 

IS 

20 while (true) { 

21 synchronised (gu&ucd) { 

22 wbile ( llistenerHero) { 

23 System, out .println( "No listener here, going to sleep... 

24 try { guard. wait (); ) 

25 catch (InterruptedSxcerption e) {) 

26 ) 

27 } 

28 p. publish { "Quote# " + ++pushCounter + " IBM 118"); 

29 System. out-println ( "Published quote# " + pushCounter); 

30 try C 

31 Thread. currentThreadO .sleep (1000) ; 

32 ) catch (InterruptedExcept ion e) {) 

33 ) 

34 } 
35 

36 public void handleChannalViewChEingeEvent 
(ChaxmelviewChangeEvent e) { 

Developing Publish/Subscribe Applications with IBus - Technical White Paper Page 7 



PACE 3W30 ' RCVD AT 5/30^2004 1:20:27 PM [Eastern Daylight Time] ■ 8VR:USPTO-EFXRF-1/0 • DNIS:872930a • CSID:970513M48 • DURATION (mm-ss): 18-30 



05/30/2004 10:20 9705139948 t PAGE 

t 



37 

38 ayaehroaized (guard) { 

39 If (e.gotiffuxnXiiste&er (} > 0) ( 

40 listdstorBere truei 

41 guaxd.aotifyAlXO ; 

42 > elae { 

43 listeaerKore a falaej 

44 > 

45 > 

46 } 

47 ) 

To keep the code luinimal we let class SmartQuateProducer implement intetface Channel- 
ViewChangeListener (line 3) instead of providing a separate class. We also need to provide 
the handleChannelviewChangeEvent method on lines 36 to 46. This method checks wheth- 
er any consumers are running aine 39) and notifies the main thread (line 40 and 4i). The variable 
lis tenerHere indicates whether at least one consumer is available on the channel. 
The main thread checks the state of the listenerHere variable and is suspended on line 24 
when there are no more consumers. If handleChannelviewChangeEvent detects the pres- 
ence of consumers, it sets the listenerHere variable and resumes the main thread. The main 
thread then proceeds with the publishing of events. As soon as the last consumer has gone the main 
thread is suspended again, and so forth. 

4 iBus Programming Model 

,?.yeat7pn^^ and JavaBeans compliant, ito addUio^^ 

1^ main i^J*i classes are? ' ' ' ' ^ - 

o Channel: to represent a communication channel by which producers and consumers exchange 
events. 

° ChannelURL: to name a channel such that producers and consumers can communicate with 
each other and assign qualities of service to channels. 

• Producer: to inject objects into a Channel (push model) 

« Subscriber: to receive events from a Channel and delegate those events to a local 
PublishEvent Listener object (push model). 

* Requester: this class allows a client application to issue a blocking request/i"eply style 
operation. 

Replyer : this class allows a s^er to answer a request/reply style operation. 

Channel, Producer, SuJDscriber, Requester, and Replyer are JavaBeans which can be 

SSSigSfe frojE^^!^ environment pS^elu]maa^^ 

teSS..t9.MS.3. Q9S to a chann examined next. ' ' " 

4.1 ChanxKalURL Class 

iBus channel URLs obey the format 

" i^^s : " ^MI:T2?^ll^ddres3] [ " : " address parameter] " / " topi c 
^^Se 8 @ SoftWired AG 1999 
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'^^^iy^^:m^o[, descriptor " ibus : " . ,pe ^'r^ is an o^o^oS 
then reliable IP multicast is chosen by default. ' . -. . fW^h: a no i^o:> is given 

^''°\°P^?"^"yvl?tel?Bl^«P'^^^^and address parameter can be specified. Thus an IP address the 
waveJength of a Satellite lirO^ etc. can be assigned to a channel. The format of thfaddms^ S 
ajldress para^neter depend on the QoS. The address parameter can be a port numbi a S r^te at 
If no address xs given tl.en iBus will pick a default. In the case of IP multicast miSS id,^S 

a network-centnc nanung service. ""«-uiig 
The topic is a mandatory string describing the content of the channel. Some examples: 

^^ZlA^i'^°''^Vu^^JJ^^'^^''^^^^'- °"^y provides a topic, the other parts are left 

o their defaults. Rehable IP multicast is used. The IP address is computed out of the bash code of 
iJie topic. 

^^^^Vy^^^ ■ ^ : ^ ■ ^3/<3"°tes/zrh/bluechips: As in thepiEvious example, buta specif- 
ic IP address is assigned to the channel. This grants developere and system administrations full con- 
trol over the allocation of IP multicast channels in their intranet. 

ibus : //251 1 1 . 13 : 7771/guotes/2rh/bluechips: Aport number other than the 
iBus default (8733) is used. 

ffiaiSlW: aH Dat^ j5 ena-ypted and 

sent via IP multicast. 

aSsaiy^ililB^ : Unreliable multicast is 

chosen to transmit real-time audio in a best effort manner via UDP. 

ibus : TCP : / / / sof tware.updates: A TCP channel is used to push software updates via the 
Internet (server part). 

ibus : TCP : //upciates . softwired-inc.eom/software_updates:ATCP/IPchanneI 
IS used to receive software updates from the Internet host updates . sof twired-inc . com 
(chent part). 

ibus: //astra-satellite-X:89760000/quotes/2rh/bluechips: Financial infor- 
mation is distnbuted via a satellite network. 

5 iBus Quality of Service Framework 

mmf^^^^S^Mmm cn^neryw:,:^^^ ehiil 

signed to deliver information via a satellite network can be developed and tested conveniently on 
PCs in^rconnected by a TCP/IP network. When the field tests start, the QoS of the channels are 

S^^Setworicto thesaj^ ^ - ^- ■ ■ 

5.1 Protocol Stacks 

Il'r.iit?.?"^ ftBHiework is open and can be extended by the developer with as yet unsupported 
qualities of service. However, mo.u developers will simply deploy the existing iBus QoS and there- 
fore do not need to be infoi-med of what is described in this section, yooanatnere 
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m a channel, it is passed to the Dratocol'fitarVnf th^ oh 

; ^.f r;: ^:'^" -; the next protocol obiect in the stack, 

md mmSfkmMsta^^^^ process is depicted in Figute 1! ' ■ p . 

OS'S frVf''' ? ^ '"^^^ fi^^ objects is used. Tlie topmost 

Object OTIAG) fragments and reassembles objects that are larger than the underlymg UDP datagram 

!2?L^S,feetww^^^^ 
^IjSge snltiast^H^^ 

unsubscnptions. Finally. PMCAST sends and receives VDP datagrams by IP multicast. 
The protocol stack framework makes for higher modularity, better maintainabihty and extensibility 
Of iBus and of iBus based applications. Since each protocol object performs only one specific task 
protocol stacks can be composed that include only a subset of the fiilly reliable multicast protocol 
objects. Besides reliable IP multicast, iBus also provides protocol objects for TCP/E>, for data en- 
cryption, data compression, for persistent channels and more. 
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5.2 Extending the QoS Framework 

The fflus QoS frameworkcan be extended by implementing new protocol objects. These objects c 



call 
en 



ibus : MyCrypt : alias (reliable ) : / / / topic 
Developing Publish/Subsaibe Applications with iBus - Technical White Paper Page 1 1 

PA E 40/50 * RCVD AT 5/30/2004 1:20:27 PM [Eastern Daylight Time] * 8VR:U8PTO-EFXRF-1/0 * DNIS:872g306 * 0810:0705139948 * DURATION (mm-ss):18-30 



85/30/2084 10:28 9705139948 



PAGE 41 



c^^^^'TKi/' ""f'^"^ a publisher of events then the events will be enciypted by theMv- 

6 Conclusions 

OoS '^'1 "^"^^ ' ^""y ^'^'^ publish/subscribe software bus and an extensible 

Qo? framework purely m Java. iBus only requires the JDK and can be installed a,xd deployrje^ 

l^JSl i^^^l ^^ir^^^ ^'""^'"^ '"'"P'^^^ distiibnted applications to be developed and ex- 

dXCd^ifsid'^^^tr*"^'^ 



7 Obtaining the iBus Software 

Trial versions of iBus can be downloaded from the iBus home page at 
http : / /www . sof twired-inc . com/ ibua 



Please contact us if you need more information: 

maxlto: mfoQsof twired-inc .com 
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